home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 1 / ACE CD 1.iso / files / games / m-z / sherloi.lha / Docs / Amiga.txt < prev    next >
Encoding:
Text File  |  1994-05-22  |  10.6 KB  |  241 lines
  1. The InfoTaskForce Infocom Interpreter Version 4.01
  2. ==================================================
  3.  
  4. Amiga Release 1.45 by David Kinder
  5. ==================================
  6.  
  7. Fed up of the rather crude official Infocom interpreters? Annoyed that
  8. Lost Treasures of Infocom II wasn't released for the Amiga? Then read on...
  9.  
  10. There have been several ports of Infocom interpreters to the Amiga, but none
  11. of this program. The interpreter supports v1, v2, v3 (Zork1 to Stationfall),
  12. v4 (Trinity, Bureaucracy, etc.) and v5 (Sherlock, Beyond Zork, etc.) games.
  13. With this interpreter you can play ALL the games in the 3.5" disk LToI2
  14. package for the IBM PC, by copying the datafiles with CrossDOS or similar,
  15. then just running this interpreter. This program requires AmigaDOS 2.04 or
  16. higher to run.
  17.  
  18. As far as I am aware, as of Release 1.40, this interpreter supports all
  19. the features of Infocom data files relevant to the Amiga. If you find
  20. otherwise, please let me know.
  21.  
  22. Amiga Features
  23. ==============
  24.  
  25. * Click on the "Infocom" icon then double-click on a game file icon to
  26.   load and run that game.
  27.  
  28. * If the project icon "Icon.Data" is present in the same directory as
  29.   "Infocom", saved game files have this icon when "Infocom" is used from
  30.   the Workbench.
  31.  
  32. * The following can be added to the ToolTypes field of the "Infocom" icon
  33.   (not game file icons):
  34.  
  35.     ATTRIBUTES    - equivalent to -a command line switch
  36.     PRELOAD    - equivalent to -l command line switch
  37.     NOPAGING    - equivalent to -p command line switch
  38.     TRANSFER    - equivalent to -t command line switch
  39.     BZCOLOURS    - use "Beyond Zork" colour scheme with the graphics file.
  40.           The synonym "BZCOLORS" is also accepted. Equivalent to
  41.           -z command line switch.
  42.  
  43. * If started from Workbench without a game file, scans the assignment
  44.   INFOCOM: (and its sub-directories) for valid Infocom game files. To
  45.   speed up scanning files are ignored if their name contains a ".",
  46.   unless the filename ends in ".data".
  47.   A list of all the games found will appear - click on the game you
  48.   want to play and it will load and run. At the bottom of this list is
  49.   a "Select with File Requester" gadget. Clicking on this gadget
  50.   opens a file requester with which you can select the game to play.
  51.   This list can also be made to appear by starting "Infocom" from the
  52.   Shell with the -w switch. Note that this must be the only argument, i.e.
  53.  
  54.     Infocom -w
  55.  
  56.   is the only valid use of this switch.
  57.  
  58. * Sound support for "The Lurking Horror". Copy all the sound files to the
  59.   subdirectory "Sound" in the directory containing the Lurking Horror data
  60.   file, e.g.
  61.  
  62.     DataFiles/LurkingHorror        <- data file
  63.     DataFiles/Sound/s#?.dat        <- sound files
  64.     DataFiles/Sound/s#?.mid
  65.  
  66. * If asl.library is available, "Infocom" uses the file requester for
  67.   Save/Restore operations. Default name is the name of data file, minus
  68.   any extensions and with ".Save" appended.
  69.  
  70. * Pressing the Help key gives the game currently playing, its author and
  71.   the difficulty level (where available).
  72.  
  73. * Screen opened clones the Workbench screen to use its size, resolution
  74.   and fonts. If possible, screen is public, with name "Infocom". The type
  75.   of screen appears in the "Help" requester.
  76.  
  77. * Support for "Beyond Zork":
  78.     Interpreter uses Amiga graphics file (if it is found). Copy the
  79.   "Graphics.Data" file to wherever the "Beyond Zork" story file is kept.
  80.   The file may alternatively be called "BeyondZork.gfx". Use of the
  81.   graphics file requires that the window text is an 8×8 non-proportional
  82.   font. If the font does not match these characteristics, then topaz/8
  83.   will be used instead.
  84.     If the graphics file is present, the interpreter can use the "Beyond
  85.   Zork" colour scheme. This feature is activated by the -z command line
  86.   switch or the "BZCOLOUR" icon tooltype. The colour scheme can then be
  87.   changed in the game with the "color" command.
  88.     The arrow keys can be used to select items in the startup menus.
  89.     The function keys are preloaded with commands, which can be changed
  90.   from within the game with the "define" command.
  91.     The numeric keypad and the mouse can be used to select a direction.
  92.   To use the mouse, click in the map to indicate the direction you wish
  93.   to move in.
  94.  
  95. * Support for the internal clock in "Border Zone" - this clock runs
  96.   regardless of whether you type in commands or not.
  97.  
  98. * The current line can be edited using backspace, delete, and the left
  99.   and right cursor keys. The shifted cursor keys move the cursor to the
  100.   beginning and end of the current line, respectively.
  101.  
  102. * Input lines have a history buffer. Use cursor up and down to scroll
  103.   through the buffer, and shift cursor up and down to go to the top and
  104.   bottom of the buffer, respectively.
  105.  
  106. * Debugging command support. Some data files contain the debugging
  107.   commands #record, #unrecord and #command (#reco, #unre and #comm in
  108.   version 3 games). These commands enable and disable recording of input,
  109.   and play the recording back, respectively.
  110.  
  111. * "Infocom" uses standard input/output if the -c switch is specified. This
  112.   allows "Infocom" to eg. take input from a file, or to be used over a
  113.   network. In the latter case, the output terminal must support ANSI 3.64
  114.   character sequences.
  115.   The default size of the window used can be changed by specifying the
  116.   with and height after "-c", separated by a slash, e.g.
  117.  
  118.     Infocom -c70/20 Zork1
  119.  
  120.   starts "Zork I" in a character window of width 70 and height 20. Note
  121.   that the values are the size of the window "Infocom" expects - the actual
  122.   output window of your terminal or Shell must be at least as big as these
  123.   values.
  124.   If you use a CON: window for input, then you will notice functions which
  125.   use an individual key press (e.g. scrolling up and down the list of hints
  126.   in "Sherlock") behave slightly differently. CON: windows only pass input
  127.   to the program after return is pressed, so if the program is expecting
  128.   single key presses, entering 'q' and pressing return causes the program
  129.   to see a 'q' character followed by a return character. If, say, you wish
  130.   the program to see two 'q' characters in a row, to e.g. quit out of a
  131.   hint screen after reading a hint, enter 'qq' followed by return.
  132.  
  133. * "Infocom" can use left and right margins (set in "InfoPrefs") so that the
  134.   text is not flush with the screen border. This can be useful to make the
  135.   text more readable if you are using a program to give screens black
  136.   borders.
  137.  
  138. * Some options in the interpreter can be defined using the external
  139.   configuration editor, "InfoPrefs", which requires that either
  140.   asl.library v38 or higher or reqtools.library v38 or higher is in
  141.   LIBS:. By default, reqtools.library is only used if asl.library v38+
  142.   is not available, but this can be over-ridden with the icon tooltype
  143.   REQTOOLS. "InfoPrefs" allows you to change:
  144.     Whether data files are pre-loaded or not.
  145.     Whether "Beyond Zork" uses its custom colour scheme.
  146.     Whether the interpreter opens a custom screen or a Workbench
  147.      window.
  148.     If applicable, the screen mode, and its depth.
  149.     If applicable, whether the Workbench window size is determined by
  150.       the program or is pre-set by the user.
  151.     The window font, and, if applicable, the screen font.
  152.     The size of the character window used in standard input/output mode.
  153.     The size of left and right margins.
  154.     The default screen colours. This option requires reqtools.library to
  155.       work.
  156.   The configuration is stored in the environment variable "Infocom.prefs",
  157.   which is read in by "Infocom" at startup.
  158.  
  159. Finally
  160. =======
  161.  
  162. If you find any bugs, please let me know. In particular, the program
  163. contains an internal list of all release and serial numbers of released
  164. games. If you have a game file which plays correctly, but its correct
  165. title does not show up in the Workbench startup list or in the Help
  166. requester, please tell me its release and serial numbers (obtainable with
  167. the -h command line option).
  168.  
  169. Internet Email: kinder@teaching.physics.ox.ac.uk
  170.         or    dkinder@vax.ox.ac.uk
  171.  
  172. Postal mail:    David Kinder,
  173.         2, Clwtt Cottages,
  174.         Bangor Road,
  175.         Gyfelia,
  176.         Nr. Wrexham,
  177.         Clywd.
  178.         LL13 0YL
  179.  
  180. History
  181. =======
  182.  
  183. 1.00    * First release.
  184.  
  185. 1.10    * Added support for icon tooltypes.
  186.     * If Workbench screen is larger than physical display, "Infocom"
  187.       screen is kept to size of physical display.
  188.     * Saved games can have icons if "Icon.Data" icon present.
  189.     * A "Strike any key to exit." prompt appears if there is text to
  190.       be read before the game quits.
  191.     * Public screen opened if possible.
  192.     * Save/Restore uses asl.library if available.
  193.     * Better error reporting from Workbench.
  194.     * Scripting in "AMFV" fixed.
  195.     * Initial game list ignores files with ".#?" extensions except
  196.       ".data". List now also looks in sub-directories of INFOCOM:
  197.       for game files.
  198.     * Initial game list has gadget to allow file requester to be
  199.       used to select the game file to load.
  200.     * Lines of text longer than the screen are handled better.
  201.     * Fixed problems with a Workbench output window appearing if
  202.       ConMan was running.
  203.     * Input text is printed in a different colour to output.
  204.     * Arrow keys now work (as used in "Beyond Zork").
  205.  
  206. 1.20    * Graphics in "Beyond Zork" supported.
  207.     * Input line history buffer.
  208.     * Better input line editing.
  209.     * Output routines buffered - text printing is now *much* faster.
  210.  
  211. 1.30    * Scripting should now work in all AMFV versions.
  212.     * Debugging commands #record, #unrecord and #command implemented.
  213.     * Problems with scripting and line editing fixed.
  214.     * Options read from "ENV:Infocom.prefs", which can be edited using
  215.       the "InfoPrefs" program.
  216.     * "Beyond Zork" now has support for different colour schemes, if
  217.       the graphic data file is available. Also, the "color" command
  218.       works correctly.
  219.     * The function keys in "Beyond Zork" are now fully supported. The
  220.       commands on the function keys can be changed in the game with
  221.       the "define" command.
  222.  
  223. 1.40    * Scanning through input line history is much faster.
  224.     * The -h option prints more information on version 5 games.
  225.     * Updated documentation on version 5 header and data flags.
  226.     * The numeric keypad and mouse now work in "Beyond Zork".
  227.     * The interpreter can now run in a Workbench window.
  228.     * "InfoPrefs" options extended.
  229.     * "Border Zone" internal clock implemented - the game time
  230.       progresses even without the intervention of the player.
  231.     * Improved handling of lines of text longer than the screen.
  232.  
  233. 1.45    * Problem of a "Lurking Horror" data file being incorrectly
  234.       recognised is now fixed.
  235.     * Switched compilers from GNU C 2.2.2 to DICE 2.07.56R. The code
  236.       is now significantly shorter.
  237.     * Added standard input/output routines.
  238.     * Text can be offset from the screen edges by margins.
  239.     * Default screen colours can be set in "InfoPrefs".
  240.     * New command line switch "-w" to display game files in INFOCOM:.
  241.